Skip to content

docs: fix layer-spec drift in 001/007/010 (pager, VFS, VDBE-write) - #617

Merged
iheitlager merged 1 commit into
mainfrom
docs/spec-002-layer-drift
Aug 28, 2026
Merged

docs: fix layer-spec drift in 001/007/010 (pager, VFS, VDBE-write)#617
iheitlager merged 1 commit into
mainfrom
docs/spec-002-layer-drift

Conversation

@iheitlager

Copy link
Copy Markdown
Member

Summary

Audit of the layers not covered by the prior spec-drift pass (#609: specs 001/002/003/005/006). This one covers pager, value-semantics, VDBE codegen/write, analyze-cost-model, VFS, and btree.

Changes

  • 001-architecture: the VFS trait/File trait code blocks were fictional (wrong method names/signatures) — replaced with the real Vfs/VfsFile surface from src/vfs.rs.
  • 007-pager: added Requirement 7 for PASSIVE WAL checkpointing (src/pager/checkpoint.rs, pager: PASSIVE checkpoint #386, ADR-0025), which had landed, tested functionality but zero spec traceability.
  • 010-vdbe-write-opcodes: the Related-regimes note described the tier-2 UPDATE stub as still future/#[ignore]d — V3 exit gate: 0.12.0 release #217 already flipped it.

006-btree's Req 4 drift (stale "(planned)" test link) was independently fixed and merged via #614 while this branch was in flight — this PR rebases past that and keeps main's (more complete) version rather than reintroducing a redundant edit.

008-value-semantics, 009-vdbe-codegen, and 011-analyze-cost-model were audited and found clean — no changes needed there.

Testing

  • make assurance: 83/83 requirements, 266/266 scenarios, no dead links
  • cargo fmt --check / cargo clippy -D warnings pass (pre-push hook)

Token spend

Ad-hoc chore (audit + fix), not a ticketed issue — no complexity estimate to match against. ~5 parallel audit forks plus targeted fixes.

Audited the remaining specs not covered by the prior spec-drift pass
(#609): pager, value-semantics, VDBE codegen/write, analyze-cost-model,
VFS, and btree.

- 001-architecture: VFS trait/File trait code blocks were fictional
  (wrong method names/signatures) — replaced with the real src/vfs.rs
  Vfs/VfsFile surface.
- 006-btree: Req 4's rowid-alias test link was marked "(planned)" even
  though rowid_alias_from_sql/with_computed_rowid_alias landed and are
  exercised by tests/unit/codegen_insert_test.rs.
- 007-pager: added Requirement 7 for PASSIVE WAL checkpointing
  (src/pager/checkpoint.rs, #386, ADR-0025), which had zero spec
  traceability despite being landed, tested functionality.
- 010-vdbe-write-opcodes: the tier2 UPDATE stub was described as still
  future/#[ignore]d; #217 already flipped it.

008-value-semantics, 009-vdbe-codegen, and 011-analyze-cost-model
audited clean, no changes needed. make assurance: 82/82 requirements,
263/263 scenarios, no dead links.

spend: ~5 audit forks + fixes, roughly matches an ad-hoc chore budget

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@iheitlager
iheitlager merged commit 245f21e into main Aug 28, 2026
@iheitlager
iheitlager deleted the docs/spec-002-layer-drift branch August 28, 2026 05:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant